home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / education / pe022.dms / pe022.adf / STARCHART / README < prev    next >
Text File  |  1991-07-12  |  5KB  |  109 lines
  1.                               StarChart
  2.                              Version 1.2
  3.                                  by
  4.                              Ray R. Larson
  5.  
  6.  
  7.                          RELEASE DOCUMENTATION 
  8.  
  9.  
  10.     This disk contains the version 1.2 release of StarChart. The primary 
  11. difference between this version and 1.1 is the addition of a 16 color 
  12. screen, so that shades of gray (or colors) can be used to represent stars 
  13. of different magnitudes. 
  14.  
  15.     With this release I am turning the source code over to whoever
  16. wants to tinker with it. The current executable file was compiled using
  17. Manx Aztec C v. 3.6a with 16 bit integers. It should compile under Lattice
  18. also, but I haven't tried that.
  19.  
  20.     The StarChart.Manual file included on this disk is simply the output
  21. of the help files included in the program.
  22.  
  23.     The program, both executable and source, may be freely distributed,
  24. but not sold without the author's permission. Feel free to modify or
  25. borrow code as needed, but I would appreciate it if you send me a copy 
  26. of the modified program.
  27.    
  28.     If you need a much fancier version of this program, with more stars
  29. and options, you might want to check out "Galileo II" by Mike Smithwick,
  30. distributed by Infinity Software. Oddly enough, although we released 
  31. the first versions of these programs about the same time, and live in 
  32. the same part of the country, we still have not met.
  33.  
  34.  
  35. Ray R. Larson
  36. 6425 Central Ave. #304
  37. El Cerrito, CA 94530
  38.  
  39. BITNET:  LARSON@UCBCMSA or LARSON@CMSA.BERKELEY.EDU
  40.  
  41.  
  42.  
  43.     
  44. APPENDIX:  Release 1.1 docs - still make some sense.
  45.  
  46.  
  47.     This disk contains the latest version of StarChart, which is still
  48. being modified to add some additional features. The main additions (so far)
  49. to the version 1.0 are a 'control panel' requester for changing the colors 
  50. used in the program, and routines to read the system clock when starting.
  51. I'm planning to add some other features before releasing the new version.
  52. These will include DPaint-style file requesters for loading and saving
  53. parameter data, and (hopefully) a world map so users can click on an
  54. observing location, and not have to look up their latitude and longitude in
  55. an atlas.
  56.  
  57.     A few things you should know about the code:
  58.     1) I have been using a beta-test version 3.30e of the Manx compiler.
  59.        It supports all of the new AmigaDOS 1.2 features, such as drawing
  60.        circles, and automatic activation of string gadgets. Supposedly
  61.        the release version of the compiler will be out shortly. This
  62.        is just to warn you that earlier versions of the compiler will
  63.        not be able to compile all of the code (you could, of course, 
  64.        modify the program to fix this.)
  65.  
  66.     2) Some of the code in the Star directory is there for future use and
  67.        is not used in Starchart proper. Some of that stuff has problems, and
  68.        may not work as-is. The real sources for StarChart can be found
  69.        by checking the makefile in Star.
  70.     
  71.     3) if you intend to print out the source for study, be warned that you
  72.        will end up with about an inch high stack of paper.
  73.  
  74.     4) the main routine of the program is in Star1.c, and Star.h defines
  75.        the data structures used throughout the program. Starglb.c (for global)
  76.        contains most of the routines that do calculation of star positions
  77.        siderial time, and so on. 
  78.   
  79.     5) If you are planning to add more stars to the program, note that the
  80.        star table (found in startab.c) is ordered by Right Ascension, also
  81.        that the tables in srchtabs.c provide indexes to the main star table
  82.        for star names, constellation, and greek letters. These are in order
  83.        by the name. (a binary search is used to search these tables, so they
  84.        have to be kept in order.)
  85.  
  86. That's about it. Enjoy poking around in the code. 
  87.     
  88.  
  89.  Credits for Star Chart:
  90.        Robert L. Hill of the Orange County, CA. Amiga Friends User Group
  91.                       wrote an original version of StarChart in AmigaBasic
  92.                       The star data and many of the main functions of this
  93.                       version are based on that program.
  94.  
  95.        Ray R. Larson  wrote the c version 1.0 of StarChart, 'intuitionizing'
  96.                       and enhancing the speed and functions of the original.
  97.  
  98.   Copyright (c) 1986 by Ray R. Larson
  99.   
  100.   This program may be freely distributed and copied, but may not be sold
  101.   without the permission of the author. If you modify or enhance it, 
  102.   please include the above credits (and please send me a copy!).
  103.  
  104. Ray R. Larson
  105. 6425 Central Ave. #304
  106. El Cerrito, CA 94530
  107.  
  108. BitNet  LARSON@UCBCMSA
  109.